home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / CD32 / CD32-Tools / simcd32-401 / SimCD32Env / ReadME < prev    next >
Encoding:
Text File  |  1993-12-22  |  1.9 KB  |  37 lines
  1.  
  2. SimCD32Env is a developer tool which enables developers to simulate
  3. the envirnoment of the AmigaCD32 upon bootup. The simulated freeanim.library
  4. included in this archive is required for SimCD32Env to function properly.
  5. This library has an internal version string of 'SimFreeAnim 1.2', to avoid
  6. confusion with the real library.
  7.  
  8. When SimCD32Env is run, a black screen is brought up to represent the
  9. AmigaCD32's startup animation. Sprites are allocated and will appear
  10. in the shape of a 'CD'. When your application calls 
  11. OpenLibrary ( "freeanim.library" ), the 'CD' will move left off of the
  12. screen and the screen will close. Then a call to CloseLibrary( freeanim.library),
  13. will return immediately after the screen has been closed. This is similiar
  14. to what happens under the real CD32 envirnoment.
  15.  
  16. The animation screen has the library opencount and closecount printed to
  17. it to monitor your application's freeanim.library calls.
  18.  
  19. The 'CD' sprites are not tied to the screen's viewport. This was done so
  20. that applications which neglect to free the startup animation, will have
  21. these sprites show up on the display.
  22.  
  23. SimCD32Env takes an optional command line parameter, CDTV.TM. If present,
  24. this switch tells SimCD32Env to simulate a CDTV trademarked boot by NOT calling
  25. SetChipRev( SETCHIPREV_AA ). If this keyword is NOT present, SimCD32Env calls
  26. SetChipRev to put the system into AGA CD32 compatible mode.
  27.  
  28. One way to test your application using SimCD32Env and SimCD32 is to make a boot
  29. floppy which starts SimCD32Env and SimCD32, mounts cd0:, assigns everything over
  30. to cd0:, and then executes the cd0:s/startup-sequence.
  31.  
  32. The SimCDEnv.lha archive contains everything needed to do this. Just unarchive
  33. this to a floppy and use the install command to make the floppy bootable. You
  34. will need to edit the floppy's startup-sequence to point SimCD32 to the proper
  35. path on your hard drive to the ISOimage you wish to use.
  36.  
  37.